[Top] [Prev] [Next] [Bottom] [Contents]

SaTableItemExt

Prints an HTML table item fragment to an HTML stream. The HTML table element is not supported by all client browsers.

Synopsis

#include "SaRnHtml.h"
int SaTableItemExt(char* evalue, int rows, 
				int cols, int align, int nowrap);

Arguments

evalue
A string specifying the value of the HTML table item. This string is converted to an HTML-compatible string. If evalue is NULL, an empty string is used.
rows
An integer specifying the number of rows an HTML table element item spans. If rows is greater than zero, the HTML fragment:
ROWSPAN="rows" 
is added to the HTML stream. Otherwise the fragment is suppressed.
cols
An integer specifying the number of columns an HTML table element item spans. If cols is greater than zero, the HTML fragment:
COLSPAN="cols"
is added to the HTML stream. Otherwise the fragment is suppressed.
align
An integer specifying which alignment fragment to use. Valid define constants and their associated HTML fragments are:
SA_NOALIGN SA_TOP ALIGN="TOP" SA_MIDDLE ALIGN="MIDDLE" SA_BOTTOM ALIGN="BOTTOM" SA_LEFT ALIGN="LEFT" SA_CENTER ALIGN="CENTER" SA_RIGHT ALIGN="RIGHT"
nowrap
An integer flag specifying whether to disable line wrapping. A non-zero value adds the HTML fragment:
NOWRAP
to the HTML stream. Otherwise, the fragment is suppressed.

Return Values

Returns an integer with a value of 0.

Description

Prints an HTML table item fragment to an HTML stream. The HTML table element is not supported by all client browsers.

Example

The code fragment:

SaTableItemExt("Sapphire", 2, 2, SA_CENTER);
will write:

<TD  NOWRAP ROWSPAN="2" COLSPAN="2" 
ALIGN="CENTER">Sapphire</TD>
to the output stream.

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.